home *** CD-ROM | disk | FTP | other *** search
/ Linux Cubed Series 3: Developer Tools / Linux Cubed Series 3 - Developer Tools.iso / devel / lang / lisp / stk-3.002 / stk-3 / STk-3.1 / Tk / unix / README < prev    next >
Encoding:
Text File  |  1996-05-31  |  6.4 KB  |  121 lines
  1. This is the directory where you configure, compile, test, and install
  2. UNIX versions of Tk.  This directory also contains source files for Tk
  3. that are specific to UNIX.
  4.  
  5. The rest of this file contains instructions on how to do this.  The
  6. release should compile and run either "out of the box" or with trivial
  7. changes on any UNIX-like system that approximates POSIX, BSD, or System
  8. V.  We know that it runs on workstations from Sun, H-P, DEC, IBM, and
  9. SGI, as well as PCs running Linux, BSDI, and SCO UNIX.  To compile for
  10. a PC running Windows, see the README file in the directory ../win.  To
  11. compile for a Macintosh, see the README file in the directory ../mac.
  12.  
  13. SCCS: @(#) README 1.13 96/04/17 11:40:46
  14.  
  15. How To Compile And Install Tk:
  16. ------------------------------
  17.  
  18. (a) Make sure that the Tcl 7.5 release is present in the directory
  19.     ../../tcl7.5.  This release of Tk will only work with Tcl 7.5.
  20.     Also, be sure that you have configured Tcl before you configure
  21.     Tk.
  22.  
  23. (b) Check for patches as described in ../README.
  24.  
  25. (b) Type "./configure".  This runs a configuration script created by GNU
  26.     autoconf, which configures Tcl for your system and creates a
  27.     Makefile.  The configure script allows you to customize the Tcl
  28.     configuration for your site; for details on how you can do this,
  29.     type "./configure -help" or refer to the autoconf documentation (not
  30.     included here).  Note:  Tk will use the same C compiler (e.g. gcc)
  31.     as Tcl, as well as several other of Tcl's configuration options.
  32.     You should not usually modify CC in the Makefile generated here
  33.     (if do you, be sure to check all of the definitions related to dynamic
  34.     loading to make sure that they are still correct).  Tk's "configure"
  35.     supports the following special switches in addition to the standard ones:
  36.     --with-tcl=DIR        Specifies the directory containing the Tcl
  37.                 binaries and Tcl's platform-dependent
  38.                 configuration information.  By default
  39.                 the Tcl directory is assumed to be in the
  40.                 location given by (a) above.
  41.     --enable-shared        If this switch is specified, Tk will compile
  42.                 itself as a shared library if it can figure
  43.                 out how to do that on this platform.
  44.     Note: be sure to use only absolute path names (those starting with "/")
  45.     in the --prefix and --exec_prefix options.
  46.  
  47. (d) Type "make".  This will create a library archive called "libtk.a"
  48.     or "libtk.so" and an interpreter application called "wish" that
  49.     allows you to type Tcl commands interactively or execute script files.
  50.  
  51. (e) If the make fails then you'll have to personalize the Makefile
  52.     for your site or possibly modify the distribution in other ways.
  53.     First check the file "porting.notes" to see if there are hints
  54.     for compiling on your system.  Then look at the porting Web page
  55.     described later in this file.  If you need to modify Makefile,
  56.     there are comments at the beginning of it that describe the things
  57.     you might want to change and how to change them.
  58.     
  59. (f) Type "make install" to install Tk's binaries and script files in
  60.     standard places.  You'll need write permission on the installation
  61.     directoryies to do this.  The installation directories are
  62.     determined by the "configure" script and may be specified with
  63.     the --prefix and --exec_prefix options to "configure".  See the
  64.     Makefile for information on what directories were chosen; you
  65.     can override these choices by modifying the "prefix" and
  66.     "exec_prefix" variables in the Makefile.
  67.  
  68. (g) At this point you can play with Tk by invoking the "wish"
  69.     program and typing Tcl commands.  However, if you haven't installed
  70.     Tk then you'll first need to set your TK_LIBRARY environment
  71.     variable to hold the full path name of the "library" subdirectory.
  72.     If you haven't installed Tcl either then you'll need to set your
  73.     TCL_LIBRARY environment variable as well (see the Tcl README file
  74.     for information on this).  Note that installed versions of wish,
  75.     libtk.a, libtk.so, and the Tk library have a version number in their
  76.     names, such as "wish4.0" or "libtk4.0.so"; to use the installed
  77.     versions, either specify the version number or create a symbolic
  78.     link (e.g. from "wish" to "wish4.0").
  79.  
  80. If you have trouble compiling Tk, read through the file "porting.notes".
  81. It contains information that people have provided about changes they had
  82. to make to compile Tcl in various environments.  Or, check out the
  83. following Web URL:
  84.     http://www.sunlabs.com/cgi-bin/tcl/info.4.1
  85. This is an on-line database of porting information.  We make no guarantees
  86. that this information is accurate, complete, or up-to-date, but you may
  87. find it useful.  If you get Tk running on a new configuration and had to
  88. make non-trivial changes to do it, we'd be happy to receive new information
  89. to add to "porting.notes".  You can also make a new entry into the
  90. on-line Web database.  We're also interested in hearing how to change the
  91. configuration setup so that Tcl compiles on additional platforms "out of
  92. the box".
  93.  
  94. Test suite
  95. ----------
  96.  
  97. Tk has a substantial self-test suite, consisting of a set of scripts in
  98. the subdirectory "tests".  To run the test suite just type "make test"
  99. in this directory.  You should then see a printout of the test files
  100. processed.  If any errors occur, you'll see a much more substantial
  101. printout for each error.  In order to avoid false error reports, be sure
  102. to run the tests with an empty resource database (e.g., remove your
  103. .Xdefaults file or delete any entries starting with *).  Also, don't
  104. try to do anything else with your display or keyboard whlie the tests
  105. are running, or you may get false violations.  See the README file in
  106. the "tests" directory for more information on the test suite.
  107.  
  108. If the test suite generates errors, most likely they are due to non-
  109. portable tests that are interacting badly with your system configuration.
  110. We are gradually eliminating the non-portable tests, but this release
  111. includes many new tests so there will probably be some portability
  112. problems.  As long as the test suite doesn't core dump, it's probably
  113. safe to conclude that any errors represent portability problems in the
  114. test suite and not fundamental flaws with Tk.
  115.  
  116. There are also a number of visual tests for things such as screen layout,
  117. Postscript generation, etc.  These tests all have to be run manually and
  118. the results have to be verified visually.  To run the tests, cd to the
  119. "tests" directory and run the script "visual".  It will present a main
  120. window with a bunch of menus, which you can use to select various tests.
  121.